JaxWsPortClientInterceptor

java.lang.Object
- org.springframework.remoting.jaxws.LocalJaxWsServiceFactory
- - org.springframework.remoting.jaxws.JaxWsPortClientInterceptor

All Implemented Interfaces:

Advice, Interceptor, MethodInterceptor, Aware, BeanClassLoaderAware, InitializingBean

Direct Known Subclasses:

JaxWsPortProxyFactoryBean
```
public class JaxWsPortClientInterceptor
extends LocalJaxWsServiceFactory
implements MethodInterceptor, BeanClassLoaderAware, InitializingBean
```
MethodInterceptor for accessing a specific port of a JAX-WS service. Compatible with JAX-WS 2.1 and 2.2, as included in JDK 6 update 4+ and Java 7/8.
Uses either LocalJaxWsServiceFactory's facilities underneath, or takes an explicit reference to an existing JAX-WS Service instance (e.g. obtained via JndiObjectFactoryBean).

Since:

2.5

Author:

Juergen Hoeller

See Also:

setPortName(java.lang.String), setServiceInterface(java.lang.Class<?>), Service.getPort(javax.xml.namespace.QName, java.lang.Class<T>), RemoteAccessException, JndiObjectFactoryBean

Field Summary

Fields
Modifier and Type	Field and Description
`private java.lang.ClassLoader`	`beanClassLoader`
`private java.util.Map<java.lang.String,java.lang.Object>`	`customProperties`
`private java.lang.String`	`endpointAddress`
`private javax.xml.ws.Service`	`jaxWsService`
`private boolean`	`lookupServiceOnStartup`
`private boolean`	`maintainSession`
`private java.lang.String`	`password`
`private javax.xml.ws.WebServiceFeature[]`	`portFeatures`
`private java.lang.String`	`portName`
`private javax.xml.namespace.QName`	`portQName`
`private java.lang.Object`	`portStub`
`private java.lang.Object`	`preparationMonitor`
`private java.lang.Class<?>`	`serviceInterface`
`private java.lang.String`	`soapActionUri`
`private java.lang.String`	`username`
`private boolean`	`useSoapAction`
`private java.lang.Object[]`	`webServiceFeatures`

Constructor Summary

Constructors
Constructor and Description

JaxWsPortClientInterceptor()

Constructors
Constructor and Description
`JaxWsPortClientInterceptor()`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addCustomProperty(java.lang.String name, java.lang.Object value)` Add a custom property to this JAX-WS BindingProvider.
`void`	`afterPropertiesSet()` Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
`protected void`	`applyDefaultsFromAnnotation(javax.jws.WebService ann)` Initialize this client interceptor's properties from the given WebService annotation, if necessary and possible (i.e.
`private javax.xml.ws.WebServiceFeature`	`convertWebServiceFeature(java.lang.Object feature)` Convert the given feature specification object to a WebServiceFeature instance
`protected java.lang.Object`	`doInvoke(MethodInvocation invocation)` Perform a JAX-WS service invocation based on the given method invocation.
`protected java.lang.Object`	`doInvoke(MethodInvocation invocation, java.lang.Object portStub)` Perform a JAX-WS service invocation on the given port stub.
`protected java.lang.ClassLoader`	`getBeanClassLoader()` Return the bean ClassLoader to use for this interceptor.
`java.util.Map<java.lang.String,java.lang.Object>`	`getCustomProperties()` Allow Map access to the custom properties to be set on the stub, with the option to add or override specific entries.
`java.lang.String`	`getEndpointAddress()` Return the endpoint address to specify on the stub.
`javax.xml.ws.Service`	`getJaxWsService()` Return a reference to an existing JAX-WS Service instance, if any.
`java.lang.String`	`getPassword()` Return the password to specify on the stub.
`java.lang.String`	`getPortName()` Return the name of the port.
`protected javax.xml.namespace.QName`	`getPortQName()` Return the prepared QName for the port.
`protected java.lang.Object`	`getPortStub()` Return the underlying JAX-WS port stub that this interceptor delegates to for each method invocation on the proxy.
`protected java.lang.Object`	`getPortStub(javax.xml.ws.Service service, javax.xml.namespace.QName portQName)` Obtain the port stub from the given JAX-WS Service.
`java.lang.Class<?>`	`getServiceInterface()` Return the interface of the service that this factory should create a proxy for.
`java.lang.String`	`getSoapActionUri()` Return the SOAP action URI to specify on the stub.
`java.lang.String`	`getUsername()` Return the username to specify on the stub.
`java.lang.Object`	`invoke(MethodInvocation invocation)` Implement this method to perform extra treatments before and after the invocation.
`boolean`	`isMaintainSession()` Return the "session.maintain" flag to specify on the stub.
`protected boolean`	`isPrepared()` Return whether this client interceptor has already been prepared, i.e.
`boolean`	`isUseSoapAction()` Return the "soapaction.use" flag to specify on the stub.
`void`	`prepare()` Initialize the JAX-WS port for this interceptor.
`protected void`	`preparePortStub(java.lang.Object stub)` Prepare the given JAX-WS port stub, applying properties to it.
`void`	`setBeanClassLoader(java.lang.ClassLoader classLoader)` Set the bean ClassLoader to use for this interceptor: for resolving WebServiceFeature class names as specified through `setWebServiceFeatures(java.lang.Object[])`, and also for building a client proxy in the `JaxWsPortProxyFactoryBean` subclass.
`void`	`setCustomProperties(java.util.Map<java.lang.String,java.lang.Object> customProperties)` Set custom properties to be set on the stub.
`void`	`setEndpointAddress(java.lang.String endpointAddress)` Set the endpoint address to specify on the stub.
`void`	`setJaxWsService(javax.xml.ws.Service jaxWsService)` Set a reference to an existing JAX-WS Service instance, for example obtained via `JndiObjectFactoryBean`.
`void`	`setLookupServiceOnStartup(boolean lookupServiceOnStartup)` Set whether to look up the JAX-WS service on startup.
`void`	`setMaintainSession(boolean maintainSession)` Set the "session.maintain" flag to specify on the stub.
`void`	`setPassword(java.lang.String password)` Set the password to specify on the stub.
`void`	`setPortFeatures(javax.xml.ws.WebServiceFeature... features)` Specify WebServiceFeature objects (e.g.
`void`	`setPortName(java.lang.String portName)` Set the name of the port.
`void`	`setServiceInterface(java.lang.Class<?> serviceInterface)` Set the interface of the service that this factory should create a proxy for.
`void`	`setSoapActionUri(java.lang.String soapActionUri)` Set the SOAP action URI to specify on the stub.
`void`	`setUsername(java.lang.String username)` Set the username to specify on the stub.
`void`	`setUseSoapAction(boolean useSoapAction)` Set the "soapaction.use" flag to specify on the stub.
`void`	`setWebServiceFeatures(java.lang.Object[] webServiceFeatures)` Deprecated. as of Spring 4.0, in favor of the differentiated `"serviceFeatures"` and `"portFeatures"` properties

Methods inherited from class org.springframework.remoting.jaxws.LocalJaxWsServiceFactory
createJaxWsService, getNamespaceUri, getQName, getServiceName, getWsdlDocumentUrl, setExecutor, setHandlerResolver, setNamespaceUri, setServiceFeatures, setServiceName, setWsdlDocumentResource, setWsdlDocumentUrl

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - jaxWsService
```
private javax.xml.ws.Service jaxWsService
```
  - portName
```
private java.lang.String portName
```
  - username
```
private java.lang.String username
```
  - password
```
private java.lang.String password
```
  - endpointAddress
```
private java.lang.String endpointAddress
```
  - maintainSession
```
private boolean maintainSession
```
  - useSoapAction
```
private boolean useSoapAction
```
  - soapActionUri
```
private java.lang.String soapActionUri
```
  - customProperties
```
private java.util.Map<java.lang.String,java.lang.Object> customProperties
```
  - portFeatures
```
private javax.xml.ws.WebServiceFeature[] portFeatures
```
  - webServiceFeatures
```
private java.lang.Object[] webServiceFeatures
```
  - serviceInterface
```
private java.lang.Class<?> serviceInterface
```
  - lookupServiceOnStartup
```
private boolean lookupServiceOnStartup
```
  - beanClassLoader
```
private java.lang.ClassLoader beanClassLoader
```
  - portQName
```
private javax.xml.namespace.QName portQName
```
  - portStub
```
private java.lang.Object portStub
```
  - preparationMonitor
```
private final java.lang.Object preparationMonitor
```
- Constructor Detail
  - JaxWsPortClientInterceptor
```
public JaxWsPortClientInterceptor()
```
- Method Detail
  - setJaxWsService
```
public void setJaxWsService(javax.xml.ws.Service jaxWsService)
```
    Set a reference to an existing JAX-WS Service instance, for example obtained via JndiObjectFactoryBean. If not set, LocalJaxWsServiceFactory's properties have to be specified.
    
    See Also:
    
    LocalJaxWsServiceFactory.setWsdlDocumentUrl(java.net.URL), LocalJaxWsServiceFactory.setNamespaceUri(java.lang.String), LocalJaxWsServiceFactory.setServiceName(java.lang.String), JndiObjectFactoryBean
  - getJaxWsService
```
public javax.xml.ws.Service getJaxWsService()
```
    Return a reference to an existing JAX-WS Service instance, if any.
  - setPortName
```
public void setPortName(java.lang.String portName)
```
    Set the name of the port. Corresponds to the "wsdl:port" name.
  - getPortName
```
public java.lang.String getPortName()
```
    Return the name of the port.
  - setUsername
```
public void setUsername(java.lang.String username)
```
    Set the username to specify on the stub.
    
    See Also:
    
    BindingProvider.USERNAME_PROPERTY
  - getUsername
```
public java.lang.String getUsername()
```
    Return the username to specify on the stub.
  - setPassword
```
public void setPassword(java.lang.String password)
```
    Set the password to specify on the stub.
    
    See Also:
    
    BindingProvider.PASSWORD_PROPERTY
  - getPassword
```
public java.lang.String getPassword()
```
    Return the password to specify on the stub.
  - setEndpointAddress
```
public void setEndpointAddress(java.lang.String endpointAddress)
```
    Set the endpoint address to specify on the stub.
    
    See Also:
    
    BindingProvider.ENDPOINT_ADDRESS_PROPERTY
  - getEndpointAddress
```
public java.lang.String getEndpointAddress()
```
    Return the endpoint address to specify on the stub.
  - setMaintainSession
```
public void setMaintainSession(boolean maintainSession)
```
    Set the "session.maintain" flag to specify on the stub.
    
    See Also:
    
    BindingProvider.SESSION_MAINTAIN_PROPERTY
  - isMaintainSession
```
public boolean isMaintainSession()
```
    Return the "session.maintain" flag to specify on the stub.
  - setUseSoapAction
```
public void setUseSoapAction(boolean useSoapAction)
```
    Set the "soapaction.use" flag to specify on the stub.
    
    See Also:
    
    BindingProvider.SOAPACTION_USE_PROPERTY
  - isUseSoapAction
```
public boolean isUseSoapAction()
```
    Return the "soapaction.use" flag to specify on the stub.
  - setSoapActionUri
```
public void setSoapActionUri(java.lang.String soapActionUri)
```
    Set the SOAP action URI to specify on the stub.
    
    See Also:
    
    BindingProvider.SOAPACTION_URI_PROPERTY
  - getSoapActionUri
```
public java.lang.String getSoapActionUri()
```
    Return the SOAP action URI to specify on the stub.
  - setCustomProperties
```
public void setCustomProperties(java.util.Map<java.lang.String,java.lang.Object> customProperties)
```
    Set custom properties to be set on the stub.
    Can be populated with a String "value" (parsed via PropertiesEditor) or a "props" element in XML bean definitions.
    
    See Also:
    
    BindingProvider.getRequestContext()
  - getCustomProperties
```
public java.util.Map<java.lang.String,java.lang.Object> getCustomProperties()
```
    Allow Map access to the custom properties to be set on the stub, with the option to add or override specific entries.
    Useful for specifying entries directly, for example via "customProperties[myKey]". This is particularly useful for adding or overriding entries in child bean definitions.
  - addCustomProperty
```
public void addCustomProperty(java.lang.String name,
                              java.lang.Object value)
```
    Add a custom property to this JAX-WS BindingProvider.
    
    Parameters:
    
    name - the name of the attribute to expose
    
    value - the attribute value to expose
    
    See Also:
    
    BindingProvider.getRequestContext()
  - setPortFeatures
```
public void setPortFeatures(javax.xml.ws.WebServiceFeature... features)
```
    Specify WebServiceFeature objects (e.g. as inner bean definitions) to apply to JAX-WS port stub creation.
    
    Since:
    
    4.0
    
    See Also:
    
    Service.getPort(Class, javax.xml.ws.WebServiceFeature...), LocalJaxWsServiceFactory.setServiceFeatures(javax.xml.ws.WebServiceFeature...)
  - setWebServiceFeatures
```
@Deprecated
public void setWebServiceFeatures(java.lang.Object[] webServiceFeatures)
```
    Deprecated. as of Spring 4.0, in favor of the differentiated "serviceFeatures" and "portFeatures" properties
    
    Specify WebServiceFeature specifications for the JAX-WS port stub: in the form of actual WebServiceFeature objects, WebServiceFeature Class references, or WebServiceFeature class names.
    As of Spring 4.0, this is effectively just an alternative way of specifying "portFeatures". Do not specify both properties at the same time; prefer "portFeatures" moving forward.
  - setServiceInterface
```
public void setServiceInterface(java.lang.Class<?> serviceInterface)
```
    Set the interface of the service that this factory should create a proxy for.
  - getServiceInterface
```
public java.lang.Class<?> getServiceInterface()
```
    Return the interface of the service that this factory should create a proxy for.
  - setLookupServiceOnStartup
```
public void setLookupServiceOnStartup(boolean lookupServiceOnStartup)
```
    Set whether to look up the JAX-WS service on startup.
    Default is "true". Turn this flag off to allow for late start of the target server. In this case, the JAX-WS service will be lazily fetched on first access.
  - setBeanClassLoader
```
public void setBeanClassLoader(java.lang.ClassLoader classLoader)
```
    Set the bean ClassLoader to use for this interceptor: for resolving WebServiceFeature class names as specified through setWebServiceFeatures(java.lang.Object[]), and also for building a client proxy in the JaxWsPortProxyFactoryBean subclass.
    
    Specified by:
    
    setBeanClassLoader in interface BeanClassLoaderAware
    
    Parameters:
    
    classLoader - the owning class loader; may be null in which case a default ClassLoader must be used, for example the ClassLoader obtained via ClassUtils.getDefaultClassLoader()
  - getBeanClassLoader
```
protected java.lang.ClassLoader getBeanClassLoader()
```
    Return the bean ClassLoader to use for this interceptor.
  - afterPropertiesSet
```
public void afterPropertiesSet()
```
    Description copied from interface: InitializingBean
    
    Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
    This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.
    
    Specified by:
    
    afterPropertiesSet in interface InitializingBean
  - prepare
```
public void prepare()
```
    Initialize the JAX-WS port for this interceptor.
  - applyDefaultsFromAnnotation
```
protected void applyDefaultsFromAnnotation(javax.jws.WebService ann)
```
    Initialize this client interceptor's properties from the given WebService annotation, if necessary and possible (i.e. if "wsdlDocumentUrl", "namespaceUri", "serviceName" and "portName" haven't been set but corresponding values are declared at the annotation level of the specified service interface).
    
    Parameters:
    
    ann - the WebService annotation found on the specified service interface
  - isPrepared
```
protected boolean isPrepared()
```
    Return whether this client interceptor has already been prepared, i.e. has already looked up the JAX-WS service and port.
  - getPortQName
```
protected final javax.xml.namespace.QName getPortQName()
```
    Return the prepared QName for the port.
    
    See Also:
    
    setPortName(java.lang.String), LocalJaxWsServiceFactory.getQName(java.lang.String)
  - getPortStub
```
protected java.lang.Object getPortStub(javax.xml.ws.Service service,
                                       javax.xml.namespace.QName portQName)
```
    Obtain the port stub from the given JAX-WS Service.
    
    Parameters:
    
    service - the Service object to obtain the port from
    
    portQName - the name of the desired port, if specified
    
    Returns:
    
    the corresponding port object as returned from Service.getPort(...)
  - convertWebServiceFeature
```
private javax.xml.ws.WebServiceFeature convertWebServiceFeature(java.lang.Object feature)
```
    Convert the given feature specification object to a WebServiceFeature instance
    
    Parameters:
    
    feature - the feature specification object, as passed into the "webServiceFeatures" bean property
    
    Returns:
    
    the WebServiceFeature instance (never null)
  - preparePortStub
```
protected void preparePortStub(java.lang.Object stub)
```
    Prepare the given JAX-WS port stub, applying properties to it. Called by prepare().
    
    Parameters:
    
    stub - the current JAX-WS port stub
    
    See Also:
    
    setUsername(java.lang.String), setPassword(java.lang.String), setEndpointAddress(java.lang.String), setMaintainSession(boolean), setCustomProperties(java.util.Map<java.lang.String, java.lang.Object>)
  - getPortStub
```
protected java.lang.Object getPortStub()
```
    Return the underlying JAX-WS port stub that this interceptor delegates to for each method invocation on the proxy.
  - invoke
```
public java.lang.Object invoke(MethodInvocation invocation)
                        throws java.lang.Throwable
```
    Description copied from interface: MethodInterceptor
    
    Implement this method to perform extra treatments before and after the invocation. Polite implementations would certainly like to invoke Joinpoint.proceed().
    
    Specified by:
    
    invoke in interface MethodInterceptor
    
    Parameters:
    
    invocation - the method invocation joinpoint
    
    Returns:
    
    the result of the call to {@link Joinpoint#proceed(); might be intercepted by the interceptor
    
    Throws:
    
    java.lang.Throwable - if the interceptors or the target object throws an exception
  - doInvoke
```
protected java.lang.Object doInvoke(MethodInvocation invocation)
                             throws java.lang.Throwable
```
    Perform a JAX-WS service invocation based on the given method invocation.
    
    Parameters:
    
    invocation - the AOP method invocation
    
    Returns:
    
    the invocation result, if any
    
    Throws:
    
    java.lang.Throwable - in case of invocation failure
    
    See Also:
    
    getPortStub(), doInvoke(org.aopalliance.intercept.MethodInvocation, Object)
  - doInvoke
```
protected java.lang.Object doInvoke(MethodInvocation invocation,
                                    java.lang.Object portStub)
                             throws java.lang.Throwable
```
    Perform a JAX-WS service invocation on the given port stub.
    
    Parameters:
    
    invocation - the AOP method invocation
    
    portStub - the RMI port stub to invoke
    
    Returns:
    
    the invocation result, if any
    
    Throws:
    
    java.lang.Throwable - in case of invocation failure
    
    See Also:
    
    getPortStub()

Class JaxWsPortClientInterceptor

Field Summary

Constructor Summary

Method Summary

Methods inherited from class org.springframework.remoting.jaxws.LocalJaxWsServiceFactory

Methods inherited from class java.lang.Object

Field Detail

jaxWsService

portName

username

password

endpointAddress

maintainSession

useSoapAction

soapActionUri

customProperties

portFeatures

webServiceFeatures

serviceInterface

lookupServiceOnStartup

beanClassLoader

portQName

portStub

preparationMonitor

Constructor Detail

JaxWsPortClientInterceptor

Method Detail

setJaxWsService

getJaxWsService

setPortName

getPortName

setUsername

getUsername

setPassword

getPassword

setEndpointAddress

getEndpointAddress

setMaintainSession

isMaintainSession

setUseSoapAction

isUseSoapAction

setSoapActionUri

getSoapActionUri

setCustomProperties

getCustomProperties

addCustomProperty

setPortFeatures

setWebServiceFeatures

setServiceInterface

getServiceInterface

setLookupServiceOnStartup

setBeanClassLoader

getBeanClassLoader

afterPropertiesSet

prepare

applyDefaultsFromAnnotation

isPrepared

getPortQName

getPortStub

convertWebServiceFeature

preparePortStub

getPortStub

invoke

doInvoke

doInvoke